home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / autocon.zip / AUTOCON.DOC < prev    next >
Text File  |  1993-11-07  |  49KB  |  1,063 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               A U T O C O N
  12.                                Version 2.0x
  13.                               "Free Version"
  14.                                Nov 1, 1993
  15.  
  16.                                     by
  17.                                Larry Weaver
  18.  
  19.  
  20.                       Copyright (c) 1989-93 Larry Weaver
  21.  
  22.                          32 W. Anapamu St. #149
  23.                          Santa Barbara, Ca 93101
  24.                          Office (805) 963-3765
  25.  
  26.  
  27.  
  28.  
  29.                              _______
  30.                         ____|__     |               (tm)
  31.                      --|       |    |-------------------
  32.                        |   ____|__  |  Association of
  33.                        |  |       |_|  Shareware
  34.                        |__|   o   |    Professionals
  35.                      -----|   |   |---------------------
  36.                           |___|___|    MEMBER
  37.  
  38.  
  39.                                     AUTOCON
  40.  
  41.                                   Introduction
  42.  
  43.    Definitions:
  44.  
  45.      In order to describe AutoCon, I need to establish a couple of
  46.      definitions.  When I use the word "reconfigure", I mean the
  47.      process of updating the AUTOEXEC.BAT and CONFIG.SYS files on the
  48.      boot drive, followed by an optional reboot of the system.
  49.  
  50.      When I use the word "configuration", I am referring to an
  51.      AUTOEXEC/CONFIG combination held in a record of AutoCon's
  52.      database.  You will use AutoCon to set up these combinations, and
  53.      give each of them a familiar name.
  54.  
  55.      The ^ symbol denotes the Control key, so ^F3 means hitting the
  56.      Control and the F3 key at the same time.  Alt denotes the Alt key
  57.      (tricky, huh?), so that AltR means hitting the Alt and the R key
  58.      at the same time.  ENTER (all caps) denotes hitting the Enter key.
  59.  
  60.  
  61.    Description:
  62.  
  63.      AutoCon is essentially a database manager for your AUTOEXEC.BAT
  64.      and CONFIG.SYS files.  It enables you to keep up to fifty
  65.      different configurations, and to change easily between those
  66.      configurations.
  67.  
  68.      The first time you run AutoCon, it will create a file named
  69.      AUTOCON.DAT.  That file will contain five configuration records.
  70.      Each record will contain a copy of the AUTOEXEC.BAT and
  71.      CONFIG.SYS files from the C: drive.  The records are initially
  72.      named RECORD01 - RECORD05.  When you set up a configuration for a
  73.      specific purpose, you can change the name to reflect that purpose
  74.      (something like Win3 for a Microsoft Windows configuration, and
  75.      SDOS for a simple DOS configuration).  You can add more records by
  76.      hitting the F3 key.
  77.  
  78.      AutoCon incorporates a full-screen editor to make it easy to
  79.      change the AUTOEXEC/CONFIG records.  The editor uses Turbo
  80.      IDE/Sidekick/WS-compatible keystrokes.  If you are not familiar
  81.      with these, there is an on-line help file which details all the
  82.      keystrokes.  If you desire, you can change the editor keystrokes.
  83.      The F6 key will pop up a key editor for this purpose.
  84.  
  85.      If you don't like the built-in editor, you can configure AutoCon
  86.      to use a different one.  The ^F6 key combination will pop up a
  87.      window asking for the name of the editor you wish to run.  Since
  88.      the configurations will eventually be used as AUTOEXEC.BAT and
  89.      CONFIG.SYS files, the editor must be able to produce pure ASCII
  90.      files.  You can toggle between the internal and external editors
  91.      with the ^F6 and the ShiftF6 key combinations.
  92.      After you have established your records and names, you can
  93.      reconfigure your system by entering the name of the new
  94.      configuration on the command line.  Typing "AutoCon Win3" would
  95.      cause AutoCon to copy the AUTOEXEC and CONFIG fields of the
  96.      record named Win3 into the boot drive as AUTOEXEC.BAT and
  97.      CONFIG.SYS and optionally reboot the system.
  98.  
  99.      In the interactive mode, you can page through the records and
  100.      reconfigure (using the current on-screen configuration) with a
  101.      couple of keystrokes.
  102.  
  103.      The AutoCon package also includes a device driver which will
  104.      allow you to select different configurations during the boot
  105.      process. Using this method is optional, and you can switch
  106.      between the two methods with a couple of key strokes.
  107.  
  108.  
  109.    Why AutoCon for Configuration Control:
  110.  
  111.      Three programs were initially responsible for the creation of
  112.      AutoCon: my schematic program, my scanner program, and my
  113.      programmable logic compiler.  Each of these programs require
  114.      various device drivers, and almost 600k of memory.  When the
  115.      computer is configured to run one of the three, neither of the
  116.      other two will run; in addition, if the computer is configured the
  117.      way I like to work with it, _none_ of the three will run.  After
  118.      playing with batch files for a while, I decided to write a program
  119.      to make it easy to change configurations.
  120.  
  121.      The above scenario is responsible for the default of five records
  122.      in AutoCon.  I had a regular configuration, the three special
  123.      configurations, and one for experimentation.  After I had worked
  124.      with AutoCon for a few days, I told a few of my friends about the
  125.      program and they wanted to try it.  After some very positive
  126.      feedback, I decided to try the program out in the Shareware
  127.      community.
  128.  
  129.      An unexpected bonus of using AutoCon became evident when I
  130.      received programs with automatic installation modules -- you know,
  131.      the ones that like to mess around with your AUTOEXEC and CONFIG
  132.      files.  Since your configurations are stored in a database, a
  133.      change to the AUTOEXEC and CONFIG files doesn't cause a problem.
  134.  
  135.      I'll use Windows to demonstrate.  When I got Windows, and saw
  136.      what it was going to do to my system configuration, I used my
  137.      "Simple" configuration to reconfigure my system.  This
  138.      configuration has only the basic stuff in it (path, prompt,
  139.      files, and buffers).  I then let Windows install itself.  After
  140.      the installation was finished, I called up AutoCon and created a
  141.      new configuration containing the changes Windows had made. After
  142.      playing with Windows for a while, I went back to my favorite DOS
  143.      configuration in a matter of moments.  Now, whenever I want to
  144.      run Windows, I just type "AutoCon Win3" on the command line --
  145.      and it's up and running!
  146.                          INSTALLING AUTOCON
  147.  
  148.    New Installation:
  149.  
  150.      To do a new installation of AutoCon, you need to copy four files
  151.      (AUTOCON.EXE, AUTOCON.HLP, MENU.CTL, and MENUNUM.COM) to your
  152.      hard disk.  It doesn't really matter which subdirectory you copy
  153.      them into, as long as it's included in the PATH statement.  If
  154.      you like to have files relating to booting up (such as device
  155.      drivers) in your root directory, then MENU.CTL and MENUNUM.COM
  156.      should be placed there, otherwise all four files may be placed in
  157.      the same subdirectory.  When AutoCon is started, it will first
  158.      look in the current subdirectory for its Help and data files.  If
  159.      they are not there, then AutoCon (if you are using DOS 3.3+) will
  160.      search the subdirectory it was started from.  If they are not
  161.      _there_, then AutoCon will search the PATH.  As long as the Help
  162.      and data files are in the PATH (or in the subdirectory AutoCon
  163.      was started from - DOS 3.3+), AutoCon can be installed in any
  164.      subdirectory.
  165.  
  166.      After you have copied the files, change to the subdirectory
  167.      AUTOCON.EXE was copied to, and type "AUTOCON" ENTER.  You will now
  168.      be in the interactive mode, pointing to the name of the first
  169.      configuration.  This first configuration is a special one to
  170.      AutoCon.  Several of the default parameters are stored in this
  171.      configuration.  When you make changes to the first record, you
  172.      will be asked whether you want to copy those changes across all
  173.      the records.
  174.  
  175.    IMPORTANT:  If you are currently using a disk cache program that
  176.      buffers disk writes (PC-KWIK and PCTOOLS are two that I know of),
  177.      you need to set up AutoCon to flush the cache before it reboots.
  178.      Hit the F4 key, select "Yes", then enter the command (include the
  179.      path if necessary) that causes your cache program to flush its
  180.      buffers.  In the case of PC-KWIK, it is the PC-KWIK program name
  181.      followed by /F.  AutoCon will execute this program before
  182.      reconfiguring.
  183.  
  184.      AutoCon is now installed, and ready to use.
  185.  
  186.  
  187.    Update:
  188.  
  189.      If your current AutoCon version is below 2.0 then the new
  190.      capabilities of AutoCon require a change to the AUTOCON.DAT file,
  191.      so if you are updating to V2.0x of AutoCon from 1.x you have a
  192.      little more to do: you need to copy the same four files mentioned
  193.      above to the subdirectory where the older version of AutoCon
  194.      (which will be overwritten) is installed.  There is another new
  195.      file in the AutoCon package called ACONVERT.EXE.  You need to
  196.      change to the subdirectory where AUTOCON.DAT resides, then run the
  197.      ACONVERT program.  This program will rename AUTOCON.DAT to
  198.      AUTOCON.SAV, then convert the file structure to work under AutoCon
  199.      V2.0x.  After you run ACONVERT.EXE, you no longer need the
  200.      ACONVERT.EXE file, so it can be deleted.
  201.  
  202.      The editor has a few new capabilities which will not be available
  203.      until you change the editor keys.  Call up AutoCon, then hit the
  204.      F6 key.  If you have never changed the keys, hit AltR, and
  205.      answer "Yes" to restoring the default keystrokes.  If you have
  206.      changed the keystrokes, page down to the bottom of the key list;
  207.      you will see that there are some new keys that need to be
  208.      defined.
  209.  
  210.      In either case, after copying the files, you will need to start
  211.      AutoCon and hit the F2 key.  Answer yes to update the files to the
  212.      new version.
  213.  
  214.                      MENU.CTL & MENUNUM.COM or MSDOS 6
  215.  
  216.      The addition of these two MENU files to the AutoCon package changed
  217.      its capabilities so much that I decided to skip versions 1.5 - 1.9
  218.      and go directly to version 2.0.  MENU.CTL is a device driver which
  219.      modifies the way a CONFIG.SYS file is processed by DOS (the method
  220.      copied by MSDOS 6).  It allows AutoCon to set up a menu selection
  221.      system which can be activated during the boot process.  There are
  222.      both advantages and disadvantages to this capability; the major
  223.      advantage is that you can pick the configuration you want to use
  224.      during the boot process.
  225.  
  226.      The major disadvantage is that your CONFIG.SYS and AUTOEXEC.BAT
  227.      files become quite nonstandard.  If you want four choices to be
  228.      available to you during the boot, then all four configurations
  229.      must be embedded in the AUTOEXEC and CONFIG files.  Programs like
  230.      Optimize (QEMM utility) will get very confused trying to work
  231.      with these files; most automatic installation programs will not
  232.      be able to work with them, either.
  233.  
  234.      I've designed AutoCon to be able to switch between the boot "menu"
  235.      mode and the "single" mode with just a couple of keystrokes; this
  236.      should provide the best of both worlds.  When a program like
  237.      Optimize (or perhaps the Windows installation program) needs to
  238.      work with your AUTOEXEC and CONFIG files, change to the single
  239.      configuration mode.  After the program is finished, call up
  240.      AutoCon, save the results in one of your configurations, and go
  241.      back to the menu mode.
  242.  
  243.  
  244.    MENU.CTL or MSDOS 6 Menu system:
  245.      AutoCon handles all the nitty-gritty details of interfacing to
  246.      MENU.CTL or the MSDOS 6 menu system.  The only thing you have to do
  247.      is make sure that MENU.CTL and MENUNUM.COM are in a subdirectory
  248.      included in the PATH statement (not necessary with the MSDOS 6
  249.      system).  To set up a menu system, start AutoCon in the interactive
  250.      mode (just type "AUTOCON" ENTER), then hit the AltM key
  251.      combination; this will pop up a configuration menu. Select the
  252.      configurations you want in the boot-up menu by moving the highlite
  253.      bar over the ones you want, and hit the Enter key. The selected
  254.      configurations will have a check mark in the first column.  When
  255.      you've finished selecting configurations, hit the Escape key.
  256.      AutoCon will then ask how many seconds you want to delay (see the
  257.      following note). Enter a number from 0 to 9.
  258.  
  259.      You will now be back in the main interactive screen.  Hit the AltT
  260.      key to toggle between MENU.CTL and the MDSOS 6 system.  You will
  261.      always be able to tell which mode AutoCon is in by looking at the
  262.      bottom line on the screen in the interactive mode. If it says
  263.      MENU.CTL or DOS Menu (the MSDOS 6 system) you are in (boot) Menu
  264.      mode, and if it says SINGLE you are in Single Mode.
  265.  
  266.      Hit the F2 key to reconfigure the system (the record on the screen
  267.      will be made the boot default record -- if it was not one of the
  268.      selected records, it will be added to the default list). The next
  269.      time you boot, either MENU.CTL or MSDOS 6 will take control of the
  270.      CONFIG.SYS file. If you hit a key in the default time, you will be
  271.      able to choose from the configurations you selected.
  272.  
  273.      To go back to a single configuration, start AutoCon in the
  274.      interactive mode, and hit the AltS key combination.  Change to the
  275.      configuration  you want to boot with, hit the F2 key, and
  276.      you're reconfigured,
  277.  
  278.  
  279.    Time:
  280.      When you select Menu mode, you will be asked to select how many
  281.      seconds to wait during the boot process; you may enter from 0
  282.      (the default) to 90.  If you select 0, when you see the MENU.CTL
  283.      box pop up, you will have about a second to hit a key.  If you do
  284.      hit a key in this time, the menu selection will be placed on the
  285.      screen.  If not, the boot will continue with the default record.
  286.  
  287.      If you select "N" then the menu will come up immediately during the
  288.      boot with no time delay.
  289.  
  290.      With MENU.CTL if you select any number except 0, you will see the
  291.      following messages on the screen during the boot process:
  292.  
  293.        Press Esc to select -- the default record name will be here --
  294.  
  295.        Press any other key to select a different configuration. Time =
  296.  
  297.      with a decrementing number (starting with the time chosen from
  298.      AutoCon) following the = sign.  When the time goes to 0, or the
  299.      Esc key is hit, the default record will be used to continue
  300.      the boot.
  301.  
  302.      In either case, if a key is hit, the menu choices will be placed
  303.      on the screen and you will be able to choose the one you want with
  304.      the arrow keys.  The one the arrow is pointing to when the ENTER
  305.      key is hit will be the configuration used for the boot process.
  306.  
  307.    Colors:
  308.      If you don't like the colors that MENU.CTL uses when it takes
  309.      control of the boot process, you can change them using the pull
  310.      down menu in AutoCon.  Start AutoCon, and hit the AltB
  311.      combination.  The four colors used by AutoCon can be changed with
  312.      this menu.  Select the colors you would like MENU.CTL to use, then
  313.      write out the new configuration (usually with the F2 key).
  314.  
  315.  
  316.    XMAEM.SYS:
  317.      I don't have DOS 4.0, so I don't really have experience with this
  318.      device driver.  From reading PC Magazine, I know that DOS
  319.      processes this device driver out of sequence in the CONFIG.SYS
  320.      file.  As a consequence, MENU.CTL will not be able to control it.
  321.  
  322.  
  323.    MSDOS 5.0's High and UMB flags:
  324.      Microsoft added a couple of capabilities to DOS 5.0 that pose a
  325.      special problem for MENU.CTL.  These are the DOS=HIGH/LOW and
  326.      DOS=UMB/NOUMB flags.  DOS processes these flags out of sequence,
  327.      so that by the time MENU.CTL has taken over, it has already set
  328.      itself up for their use.  DOS decides how to set the flags by
  329.      parsing the entire CONFIG.SYS file, and using the state of the
  330.      last occurrence of the DOS= statement to set the flags.
  331.  
  332.      AutoCon is still able to control these flags  though the method is
  333.      a little unorthodox.  When you are using Menu mode and MSDOS 5.0,
  334.      AutoCon will place the statement DOS=HIGH,NOUMB as the last line
  335.      in the CONFIG.SYS file.  As a consequence, DOS will attempt to
  336.      always load HIGH, and have NOUMB control.  When you select a
  337.      configuration via MENU.CTL, if that configuration has a DOS=LOW
  338.      command in it (and no other program in the configuration has taken
  339.      it), MENU.CTL will take the HMA and force DOS Low.  The HMA will
  340.      be released by MENUNUM runs (as soon as the AUTOEXEC.BAT file
  341.      starts executing).  If the selected configuration has a DOS=UMB
  342.      command, then MENU.CTL will tell DOS to control the UMBs.
  343.  
  344.      If all of this makes no sense to you, then don't worry about it.
  345.      If you are using MSDOS 5.0 and the Menu mode, just place the
  346.      appropriate DOS=HIGH/LOW and DOS=UMB/NOUMB commands in each of
  347.      your configurations, and AutoCon will do the rest.
  348.  
  349.  
  350.    DRDOS:
  351.      As of this release MENU.CTL (Version 1.4 or higher) if fully DRDOS
  352.      compatible.
  353.  
  354.  
  355.    CONFIG:
  356.      When you switch to the Menu mode, AutoCon will do all of the work
  357.      for you.  It will take your selected configurations (up to 8) and
  358.      create the AUTOEXEC.BAT and CONFIG.SYS files that will allow you
  359.      to choose during the boot process.  If you look at the CONFIG.SYS
  360.      file that has been set up for a boot menu, you will see all the
  361.      selected CONFIG fields embedded in the files.  If you're using the
  362.      MENU.CTL system then you will see DEVICE=MENU.CTL at the beginning
  363.      of the file.  When MENU.CTL is processed by DOS, it will take over
  364.      and allow you to choose the configuration you want.  After you
  365.      choose, MENU.CTL will leave the chosen configuration intact and
  366.      disable the rest.  If you're using the MSDOS 6 system, you will see
  367.      a menu compatible CONFIG.SYS file.
  368.  
  369.      If you are using DOS 4.0+, MENU.CTL disables by changing the
  370.      CONFIG.SYS commands to remarks.  If you are using DOS 3.3 or
  371.      below, it will disable the commands by turning them into
  372.      BREAK=OFF commands.  As a consequence, if you are using a DOS
  373.      below 4.0, you will need to make a couple of changes to your
  374.      CONFIG commands.  In order to have the room to convert the
  375.      LASTDRIVE, FILES, and BUFFERS commands, you will need to make the
  376.      lines longer.
  377.  
  378.      I do this by adding an * at the end of the line, as follows:
  379.        LASTDRIVE=M: * BUFFERS=10 * FILES=50 *
  380.  
  381.      If you don't do this, these commands will be disabled by making
  382.      them unrecognized.  This doesn't cause a problem: you will just
  383.      see a lot of "Unrecognized command in CONFIG.SYS" lines coming
  384.      out during the boot process.
  385.  
  386.      Note: AutoCon will also change "Unrecognized" commands to
  387.      BREAK=OFF commands if there is room.  This will allow you to
  388.      freely place REM statements in your CONFIG.SYS file (as long as
  389.      you use MENU mode).
  390.  
  391.      If you want BREAK=ON, you will have to add it to your AUTOEXEC
  392.      fields.
  393.  
  394.    AUTOEXEC:
  395.      The AUTOEXEC.BAT file will also contain all the selected
  396.      configurations AUTOEXEC fields.  If you're using MENU.CTL you will
  397.      see MENUNUM.COM at the beginning of the file.  This program will
  398.      interrogate MENU.CTL and find which configuration was chosen.
  399.      MENUNUM will set ERRORLEVEL to match the chosen menu, and an "If"
  400.      statement will cause the associated AUTOEXEC to be chosen.
  401.      If you're using the MSDOS 6.0 system, you will see an environment
  402.      variable interrogated at the beginning of the file.
  403.  
  404.    UNRECOGNIZED COMMANDS - DOS 3.3:
  405.      CONFIG.SYS files have a potential problem.  If you enter the
  406.      following two lines in your CONFIG.SYS file
  407.  
  408.        REM
  409.        DEVICE=ANSI.SYS
  410.  
  411.      ANSI.SYS will not get loaded.  Both lines will be turned into an
  412.      "Unrecognized command".  This is just something that DOS does,
  413.      and there is nothing an outside program can do about it.
  414.  
  415.      Do not end a CONFIG field with an Unrecognized command.  If you
  416.      do, the following command will also be Unrecognized, and will
  417.      definitely mess up the processing of the CONFIG.SYS file.
  418.  
  419.    CAUTION: When you start playing around with the Menu mode, be very
  420.      careful when updating or creating a configuration.  If you read
  421.      in an AUTOEXEC.BAT or CONFIG.SYS file which has been set up for
  422.      MENU mode, it will contain a lot of commands which will cause
  423.      problems if you use it in a reconfiguration.  It would be much
  424.      better to copy one of the other configurations and not update
  425.      from the AUTOEXEC and CONFIG files.
  426.  
  427.      If you have managed to read and save such a configurations, you
  428.      will need to edit and remove the extra statements inserted by
  429.      AutoCon.  If it is not obvious to you by looking at the AUTOEXEC
  430.      and CONFIG fields which statements these are, then do not attempt
  431.      to edit the field, simply copy one of the other configurations.
  432.  
  433.    Magazine Article:
  434.      Just as a side note, during the development of MENU.CTL I created
  435.      a simpler device driver and decided it would make a good subject
  436.      for a magazine article (similar to PC Magazine's CONFIG.CTL
  437.      device driver).  I wrote it up, and it was published in the Sept.
  438.      1991 issue of Tech Specialist.
  439.  
  440.  
  441.  
  442.                          NAVIGATING AUTOCON
  443.  
  444.  
  445.      Okay, now you have AutoCon installed; how do you use it?  Starting
  446.      with version 2.0, the interactive front screen of AutoCon can be
  447.      navigated with a pull-down menu.  If you need to do something and
  448.      can't remember the keystroke combination to get there, use the
  449.      menu to find it.  On the right of each menu entry is the shortcut
  450.      key combination to perform the same operation.  I am going to
  451.      define the navigation keys in the form of the pull-down menu.
  452.  
  453.    DataBase Maintenance (Records AltR)
  454.  
  455.      Previous/Next, browse records:
  456.        PgUp/PgDn allows you to page through the records one at a time.
  457.  
  458.      pIck Record:
  459.        F10 pops up a pick-list of all the configurations, and allows
  460.        you to choose one and make it current.
  461.  
  462.      Create Record:
  463.        F3 creates a new record, and copies the control structure from
  464.        record 1 and the data from the current AUTOEXEC and CONFIG
  465.        files.
  466.  
  467.      Delete Record:
  468.        ^F3 deletes the current configuration record.  Note that you
  469.        cannot delete record number 1, nor can you delete below the
  470.        default 5 records.
  471.  
  472.      Read Files:
  473.        F7 will cause the current record to be updated with the
  474.        contents of the AUTOEXEC and CONFIG files.
  475.  
  476.      Read file into AUTOEXEC (rd Auto ^F8):
  477.        ^F8 will pop up a window asking for a file name to read into
  478.        the AUTOEXEC field.  In you enter wildcards, a list of file
  479.        names will be popped up to choose from.  The AUTOEXEC field of
  480.        the current record will be replaced by the contents of the
  481.        chosen file.
  482.  
  483.      Read file into CONFIG (rd confiG ^F9):
  484.        ^F9 will pop up a window asking for a file name to read into
  485.        the CONFIG field.  In you enter wildcards, a list of file names
  486.        will be popped up to choose from.  The CONFIG field of the
  487.        current record will be replaced by the contents of the chosen
  488.        file.
  489.  
  490.      Configure and continue:
  491.        ^K^D will cause all current changes to be saved.  In other
  492.        words, it will rewrite the AUTOCON.DAT file, the AUTOEXEC.BAT
  493.        file, and the CONFIG.SYS file.
  494.  
  495.      Change BAT drive:
  496.        F8 will pop up a window to allow you to change the file the
  497.        AUTOEXEC field of a configuration is written too.  The default
  498.        name is C:\AUTOEXEC.BAT.
  499.  
  500.      Change SYS drive:
  501.        F8 will pop up a window to allow you to change the file the
  502.        CONFIG field of a configuration is written to.  The default
  503.        name is C:\CONFIG.SYS.
  504.  
  505.      cOmpare:
  506.        Alt= will compare the current configuration with the contents of
  507.        the current AUTOEXEC and CONFIG files.  It should be noted that,
  508.        if you are using the MENU.CTL device driver option, this
  509.        comparison will probably not be applicable.
  510.  
  511.      boot Type:
  512.        F5 will pop up a window to allow you to change the boot type
  513.        associated with a configuration.  The choices are Warm, Cold,
  514.        None, and External.
  515.  
  516.      Flush:
  517.        F4 will pop up a window that will allow you to associate a
  518.        cache Flush command with the current configuration record. This
  519.        is necessary when the cache used in the configuration does a
  520.        write cache operation (PC-KWIK and PCTOOLS both default to this
  521.        configuration).
  522.  
  523.      cLone:
  524.        AltC will allow you to clone (or copy) the contents/control
  525.        of one of the other configurations to the current
  526.        configuration. It will pop up a pick list of all of the
  527.        existing configurations, and allow you to pick the one to copy
  528.        from.
  529.  
  530.        If you are using the AutoCon environment variable, you will
  531.        need to edit the AUTOEXEC file, and make sure the correct name
  532.        is used.
  533.  
  534.      Update:
  535.        ^K^S will save all current record changes to the AUTOCON.DAT
  536.        database file.  Note that it will not update the AUTOEXEC and
  537.        CONFIG Files.  You must use ^K^D for that.
  538.  
  539.      rEstore:
  540.        ^K^R will abandon all changes you have made (since the last
  541.        AUTOCON.DAT save) and reload the database records from the
  542.        AUTOCON.DAT file.
  543.  
  544.  
  545.    Boot Operation (Boot AltB):
  546.  
  547.      Single:
  548.        AltS configures AUTOCON to use only the current record for
  549.        reconfiguration purposes.
  550.  
  551.      Menu:
  552.        AltM configures AutoCon to use MENU.CTL in conjunction with
  553.        MENUNUM.COM to set up a selection menu to be used during the
  554.        boot process.  A pick list of the current configurations will
  555.        be popped up, and you will be able to choose up to eight
  556.        default configurations to be included.  After you have chosen
  557.        the eight, you will be asked how many seconds to delay during
  558.        the boot process.  If a number other than 0 is entered, a
  559.        message will be placed on the screen during the boot process,
  560.        and MENU.CTL will wait that many seconds for a key to be hit.
  561.  
  562.      Toggle Menus (AltT) :
  563.        This toggles between use of MENU.CTL and (if you're using MSDOS
  564.        6) DOS's menu system.
  565.  
  566.      Toggle DOS 6 menu in single mode (AltD) :
  567.        This toggles between the use of the DOS 6 menu in single mode.
  568.        If the DOS 6 menu mode is used in single mode then AutoCon will
  569.        be able to find the boot configuration in the environment.  If
  570.        not, then the "SET AUTOCON=<name>" must be in the Autoexec field
  571.        to guarantee that AutoCon will know which configuration was used
  572.        to boot.  It does add some lines to the CONFIG.SYS file, so you
  573.        may want to turn it off.
  574.  
  575.  
  576.        Boot Frame:
  577.          When booting under menu mode, MENU.CTL pops up some windows
  578.          and this selection allows you to change the color of the
  579.          window frames of those pop up windows.
  580.  
  581.        Boot Text:
  582.          When booting under menu mode, MENU.CTL pops up some windows
  583.          and this selection allows you to change the color of the text
  584.          in those pop up windows.
  585.  
  586.        Boot Attention:
  587.          When booting under menu mode, MENU.CTL pops up some windows
  588.          and this selection allows you to change the color of the text
  589.          used to draw your attention.  This is the color of the
  590.          decrementing time variable, and the color that will be used
  591.          for warning messages.
  592.  
  593.        Boot Hi_Lite:
  594.          When booting under menu mode, MENU.CTL pops up some windows
  595.          and this selection allows you to change the color of the
  596.          moving selection hi-lite bar used to select a boot
  597.          configuration.
  598.  
  599.  
  600.    Editor options (Editor AltE):
  601.  
  602.      Internal:
  603.        ShiftF6 configures the current configuration to use the
  604.        internal editor.
  605.  
  606.      External:
  607.        ^F6 configures the current configuration to use an external
  608.        editor.  A window will pop up asking for the editor's name. You
  609.        may include a path in the name, but you must include the
  610.        extension (e.g., WORD.EXE or C:\WORD\WORD.EXE).  The next time
  611.        you edit the AUTOEXEC or CONFIG field for this record, if the
  612.        external editor can be found it will be used.  If it can't be
  613.        found, AutoCon will switch back to the internal editor.
  614.  
  615.        After the external editor has been installed, it will be used
  616.        to edit the AUTOEXEC and CONFIG fields from the main screen.
  617.        When you move the cursor to the AUTOEXEC or CONFIG field and
  618.        press enter, AutoCon will copy the current record to the
  619.        current subdirectory as XYZXYZZ.XYZ (the current subdirectory
  620.        must contain at least 4k of disk space).  AutoCon then shells
  621.        to DOS with the editor name and filename on the command line
  622.        (e.g., WS.EXE XYZXYZZ.XYZ).  When you exit your editor, AutoCon
  623.        should restart.  It will copy the XYZXYZZ.XYZ file into the
  624.        AUTOEXEC field of the current record and delete the XYZXYZZ.XYZ
  625.        file from the subdirectory.
  626.  
  627.  
  628.        CAUTION!!  Just to make sure there is no problem with your
  629.        editor, create a new record and work with it first, before
  630.        taking the chance of harming one of your current records. You
  631.        may want to make a copy of your AUTOCON.DAT file and store it
  632.        in a safe place until you've verified the operation of the new
  633.        release.  In fact, you should always keep a backup copy of
  634.        AUTOEXEC.DAT.
  635.  
  636.  
  637.      Install Keys:
  638.        F6 will pop up a window that will allow you to change the
  639.        keystrokes used in the internal editor.  F6 may also be used
  640.        while in the internal editor to see exactly which key performs
  641.        which function.
  642.  
  643.      Save Keys:
  644.        This function is really added for future action (though it is
  645.        fully functional in this release).
  646.  
  647.      Get Keys:
  648.        This function will allow you to change AutoCon's editor
  649.        keystrokes quickly by reading in a keystroke file.
  650.  
  651.  
  652.    coLors AltL:
  653.  
  654.      Frame:
  655.        AltF1 pops up a color pick window which allows you to change
  656.        the color of the frames drawn around the windows on the main
  657.        interactive screen.
  658.  
  659.      Frame Text:
  660.        AltF2 pops up a color pick window which allows you to change
  661.        the color of the text in the windows on the main screen.
  662.  
  663.      Background:
  664.        AltF3 pops up a color pick window which allows you to change
  665.        the color of the text and/or background of the main screen.
  666.  
  667.      Field:
  668.        AltF4 pops up a color pick window which allows you to change
  669.        the color of the fields that get updated on the screen, the
  670.        configuration name, the date and time, the record number, and
  671.        the select boxes.
  672.  
  673.      Prompt:
  674.        AltF5 pops up a color pick window which allows you to change
  675.        the color of the current select box.  This is the color of the
  676.        main screen select item that the cursor is positioned to.
  677.  
  678.      Edit Text:
  679.        AltF6 pops up a color pick window which allows you to change
  680.        the color of the text used in the editor.
  681.  
  682.      Marked Text:
  683.        AltF7 pops up a color pick window which allows you to change
  684.        the color of the text used to show marked blocks in the editor.
  685.  
  686.      Ctrl Text:
  687.        AltF8 pops up a color pick window which allows you to change
  688.        the color used to show control characters (value < 20 hex) in
  689.        the edit text.
  690.  
  691.      Menu Frame:
  692.        This menu item allows you to change the color of the frame
  693.        around the pulldown menus.  Note that there is no hotkey.
  694.  
  695.      Menu Text:
  696.        This menu item allows you to change the color of menu items in
  697.        the pulldown menus.  Note that there is no hotkey.
  698.  
  699.      Menu Select:
  700.        This menu item allows you to change the color of the currently
  701.        selected item in the pulldown menus.  Note that there is no
  702.        hotkey.
  703.  
  704.      Menu Hi-lite:
  705.        This menu item allows you to change the color of the Hi-lited
  706.        select character in the pulldown menus.  Note that there is no
  707.        hotkey.
  708.  
  709.      Help fRame:
  710.        This menu item allows you to change the color of the Frame drawn
  711.        around the Help Window (also changes the color of one of the
  712.        basic Help Hi-Lite color).
  713.  
  714.      Help tExt:
  715.        This menu item allows you to change the color of the text in the
  716.        Help Window.
  717.  
  718.      Help heAder:
  719.        This menu item allows you to change the color of the Header on
  720.        the Help window.  It will also be the default color of the Help
  721.        menu select color.
  722.  
  723.      Default:
  724.        AltF10 pops up a color pick window which allows you to
  725.        change all configurable colors back to the defaults.  If your
  726.        screen goes black, hit AltF10 followed by the Y key, and you
  727.        may be able to see the screen again.
  728.  
  729.  
  730.    Quit AltQ :
  731.  
  732.      Configure:
  733.        F2 reconfigures the system.  It will save any record changes in
  734.        the database file, and create new AUTOEXEC and CONFIG files. It
  735.        will then perform the requested reboot.
  736.  
  737.      Reboot:
  738.        This menu item will cause any record changes to be saved in the
  739.        database file, and force the default reboot action.  Note that
  740.        there is no hotkey.
  741.  
  742.      Exit:
  743.        This menu item will save any record changes in the database
  744.        file and exit without any reboot action -- a rough equivalent
  745.        to hitting the ESC key.
  746.  
  747.      Abandon/Exit:
  748.        ^K^Q will cause any current record changes to be abandoned, and
  749.        AutoCon will exit without any reboot action.
  750.  
  751.      Restore Screen?:
  752.        This function can only be reached through the pull down menu.
  753.        If you set this to "NO", then AutoCon will not attempt to
  754.        restore the original screen on exit.  Some video combinations
  755.        seem to have a problem with the restoration, so you can turn it
  756.        off.
  757.  
  758.  
  759.    Keys not in the Menu:
  760.  
  761.      AltV :
  762.        This key combination will show you the DOS screen as it was
  763.        when AutoCon was activated.
  764.  
  765.  
  766.  
  767.  
  768.                              COMMAND LINE OPTIONS
  769.  
  770.    Environment:
  771.      For AutoCon to work correctly with the command-line commands, it
  772.      will need to know which configuration was used for the last boot-
  773.      up.  There is only one sure way for AutoCon to get this
  774.      information: if you are using the Menu mode, MENU.CTL (or MSDOS 6)
  775.      will be able to tell AutoCon which configuration was chosen.
  776.  
  777.      If you are using Single Mode and MSDOS 6, the configurations will
  778.      be written so that the environment variable will be automatically
  779.      set.  If you look at your CONFIG.SYS you will see a single menu
  780.      setup.  When MSDOS 6 processes this, it sets the environment
  781.      variable CONFIG to the name of the configuration (unless you have
  782.      explicitely turned it off - see above).
  783.  
  784.      If you are using the Single mode (and not using MSDOS 6), to make
  785.      sure that AutoCon knows which configuration was used to boot, you
  786.      need to add a line to your AUTOEXEC fields.  The line is as
  787.      follows:
  788.  
  789.        SET AUTOCON=<Configuration Name>
  790.  
  791.      in which "configuration name" is the name that shows up on the
  792.      front screen in the interactive mode.  To make it very easy, a
  793.      new key-stroke command was added to the editor.  The default key
  794.      is AltE. Place your cursor at the position in the AUTOEXEC
  795.      field where your other SET commands are located, and press the
  796.      AltE combination.  AutoCon will insert the proper line in the
  797.      file.
  798.  
  799.      If you're using the MSDOS 6 menu system, this will be handled
  800.      automatically for you.
  801.  
  802.    Reconfigure:
  803.      To reconfigure from the command line, type
  804.  
  805.                   AUTOCON <update name> ENTER
  806.            [e.g., AUTOCON WIN3 ENTER]
  807.  
  808.      on the command line.  As long as AUTOCON.EXE and AUTOCON.DAT are
  809.      in the path, the configuration will be updated, and your system
  810.      will be rebooted (depending on the current boot choice).
  811.  
  812.      Alternatively (if you don't want to type the update name), if you
  813.      type AUTOCON / ENTER
  814.  
  815.      AutoCon will pop up a pick list of your configurations, and you
  816.      can use the arrow keys to pick a reboot configuration.
  817.  
  818.      If the update name is the same as the last boot name (see note
  819.      above), you will be asked if you really want to do the update.
  820.  
  821.  
  822.    Configuration Inquiry:
  823.      Typing AUTOCON /? will cause AutoCon to display the name it
  824.      thinks is the current configuration.
  825.  
  826.      This will be most accurate if Menu mode is active.  It should
  827.      also be quite accurate if each AUTOEXEC field has the correct
  828.      "SET AUTOCON=" command in it.
  829.  
  830.      If neither of the above applies, it will tell you which command
  831.      was last used to configure the AUTOEXEC and CONFIG files, which
  832.      may not be the configuration that was used for the last boot.
  833.  
  834.  
  835.    Specific Update:
  836.      Typing           AUTOCON /<update name> ENTER
  837.                [e.g., AUTOCON /WIN3 ENTER]
  838.  
  839.      will cause the named configuration to be updated from the current
  840.      C:\AUTOEXEC.BAT and C:\CONFIG.SYS files (or your selected BAT and
  841.      SYS filenames).  If MENU.CTL is in use, you will be asked if this
  842.      is really what you want to do.
  843.  
  844.    Generic Update:
  845.      For those of you who like to live dangerously (all of us from
  846.      time to time?), typing "AUTOCON /*" will update the current
  847.      configuration (the last one used to reconfigure) from the current
  848.      C:\AUTOEXEC.BAT and C:\CONFIG.SYS files (or your selected
  849.      filenames).  This command will be ignored if the system was
  850.      booted with MENU.CTL.
  851.  
  852.    Equal Check:
  853.      Typing "AUTOCON /=" will report on whether or not the current
  854.      configuration record is equal to the current record in the
  855.      database.
  856.  
  857.    Batch File Errorlevel Check:
  858.      Typing "AUTOCON/@<configuration name>" will set the Errorlevel to
  859.      1 if "<configuration name>" was the one used to boot the system.
  860.      This function will set the errorlevel only: there will be nothing
  861.      shown on the screen.  For full accuracy, see the Environment note
  862.      above.
  863.  
  864.  
  865.  
  866.                               NOTES AND HINTS
  867.  
  868.  
  869.  
  870.      Editor Keys:
  871.  
  872.        To find which key does what when you are in the editor, hit F6
  873.        and you will see each action the editor is capable of and the key
  874.        assigned to that action.  You may also change the default keys
  875.        while in this mode.  The next release will add pulldown menus and
  876.        a much better Help section to the editor.
  877.  
  878.        If you are unable to call up the Edit Key function while in the
  879.        editor, go back to the main screen, hit F6 to pop up the key
  880.        editor, hit END, and you will see a function called Install
  881.        Editor Keys.  Assign the default F6 key to this function -- or
  882.        any other key you like.  If you assign another key, the F6 key
  883.        will still call up the editor from the main screen, and the
  884.        assigned key will work inside the editor.
  885.  
  886.  
  887.      Boot Notes:
  888.  
  889.        Versions of AutoCon before 2.0 allowed one boot choice for all
  890.        configurations.  From this version on, you will be able to
  891.        select a boot choice for each configuration.
  892.  
  893.        AutoCon is initially configured with a warm (or soft) reboot.
  894.        Some machines have a problem with the warm boot (usually those
  895.        with a large hard disk, and a large hard-disk partition
  896.        manager) and need a cold boot instead.  If you have a reboot
  897.        problem, hit F5 and change to a cold boot.  This change will be
  898.        saved in the AUTOCON.DAT file, and AutoCon will perform a cold
  899.        boot (you'll see the memory being checked) in the future.
  900.  
  901.        Some hardware is so strange (or the software has put the CPU
  902.        into such a strange state -- Windows 3 386Enhanced mode) that
  903.        even a software cold boot doesn't suffice.  If this is the
  904.        case, then hit F5 and change to no boot.  This last will
  905.        require hitting ^AltDel after AutoCon is finished.
  906.  
  907.        A couple of add-in processor cards (plugging a 286 expansion
  908.        card into an XT) come with their own reboot program, and some
  909.        people have developed their own reboot utilities to handle
  910.        special hardware and/or software needs.  For these people,
  911.        there is another choice for rebooting.  They will need to hit
  912.        F5 and change to an External Boot.  You will need to enter the
  913.        program name that performs your reboot.
  914.  
  915.  
  916.      BAT and SYS Files:
  917.  
  918.        AutoCon is initially configured to copy the AUTOEXEC and CONFIG
  919.        fields to the C drive.  For various reasons, some people do
  920.        their real boot from a drive other than C.  The F8 key will
  921.        allow you to change the designated drive (and file name) the
  922.        AUTOEXEC field is copied too.  The F9 key performs the same
  923.        function for the CONFIG field.  The new destination files will
  924.        be saved to the AUTOCON.DAT file, and used in all future
  925.        configurations until you change them again.
  926.  
  927.        Starting with this version, the BAT and SYS files will be set
  928.        with each configuration.  Until I make some large changes in
  929.        the next version, this will allow you to edit (and keep a
  930.        database of) files other than the AUTOEXEC and CONFIG.
  931.  
  932.      LCD Users:
  933.  
  934.        If you have a computer with an LCD screen, set your mode to
  935.        BW80 (this is mode 2 for you technical people) before starting
  936.        AutoCon; that should make the screen show up better.  If you
  937.        prefer, you can start in color mode, and edit the colors to
  938.        something you find suitable.
  939.  
  940.      Screen Information:
  941.  
  942.        When you are in the data-entry mode, you have some information
  943.        on the screen.  The top line has the current date and time, as
  944.        well as the name and version of the program.  The second line
  945.        has the information on the current record, specifically the
  946.        record number, and the date and time it was last changed.  The
  947.        middle of the screen has an area for notes, so that you can
  948.        keep track of what this particular record is used for.  The
  949.        bottom two lines contain help information for the current mode.
  950.  
  951.        The %<number> on the bottom line of the note frame and of the
  952.        edit frame indicates the how full the field is.  An empty note
  953.        field is 0% full.  As you add note characters, the percentage
  954.        will increase.  (I've had some people ask.)
  955.  
  956.        The bottom line has some status information about the current
  957.        defaults.  The first word on the line will be MENU.CTL, DOS Menu,
  958.        SINGLED6, or SINGLE.  This indicates whether you are using the
  959.        device driver, or MSDOS 6's menu system to select a configuration
  960.        during the boot, or whether only a single configuration is
  961.        available. The SINGLED6 means that you are using DOS 6 with the
  962.        single menu mode set. The second word is either Internal or
  963.        External; that indicates whether the internal or the external
  964.        editor is to be used for this configuration.  The next term is
  965.        either Flush or No Flush; that indicates whether or not a Cache
  966.        Flush command will be performed for this configuration. The Next
  967.        word tells what type of boot will be performed for this
  968.        configuration; the word will be either Warm, Cold, None, or
  969.        External.  There may or may not be a last word.  If this record
  970.        will be one of the default records used with MENU.CTL, then
  971.        "Selected" will be written on the screen.
  972.  
  973.  
  974.      Old Configurations:
  975.        If you want to use some configurations you have already
  976.        defined, and you are using the internal editor, you may read
  977.        them in directly.  While in the AUTOEXEC or CONFIG edit mode,
  978.        if you hit F5 it will erase the contents of this field, but it
  979.        checks with you first.  If you then hit ^K ENTER, you will be
  980.        given a chance to enter a file name to read into the field.  If
  981.        you use wildcard notation, AutoCon will pop up a file list for
  982.        you to choose from.  The selected file name will then be read
  983.        into the current field.  Do one of the standard exit commands
  984.        (AltX, ^K X) and the field now contains the file.
  985.  
  986.        Do this for each of your current configurations, and you will
  987.        now have the convenience of AutoCon with all your standard
  988.        configurations.
  989.  
  990.        Alternately -- especially for those of you using an External
  991.        editor -- you may read in a file from the main screen.  The ^F8
  992.        key combination will allow you to specify a file name to copy
  993.        into the current AUTOEXEC field, and ^F9 performs the same
  994.        function for the CONFIG field.
  995.  
  996.  
  997.      LZEXE:
  998.        A new program from France has shown up on the scene; it is
  999.        called LZEXE.  If you use it on AUTOCON.EXE, it will reduce the
  1000.        size about fifty percent.  I am distributing the AUTOCON.EXE
  1001.        file in the LZEXE format.  If you have an XT compatible
  1002.        machine, then AutoCon may run too slow for you in this format.
  1003.        If this is the case, you can use the program UNLZEXE to restore
  1004.        it to its uncompressed format.  Both LZEXE and UNLZEXE are
  1005.        included as a bonus on the registered disk.
  1006.  
  1007.  
  1008.      PKLITE:
  1009.        Phil Katz has also written a program which will reduce the size
  1010.        of program files.  It is also completely compatible with AutoCon.
  1011.  
  1012.      DIET:
  1013.        There is also a Japanese file compressor called DIET.  AutoCon
  1014.        has also been tested and found compatible with DIET.
  1015.                                 CONTACT
  1016.  
  1017.  
  1018.      If you have a problem getting AutoCon set up or if you find a bug,
  1019.      please let me know.  The primary ways to contact me are on
  1020.      Compuserve at 72460,3072, or on the Internet at
  1021.      72460.3072@COMPUSERVE.COM.  I check in at least once a week, and I
  1022.      am usually on two or three times a week.
  1023.  
  1024.  
  1025.  
  1026.                                   FUTURE
  1027.  
  1028.      Due to the inclusion of a menuing program by Microsoft in DOS 6.0,
  1029.      and due to the fact that we're about to enter the operating system
  1030.      wars (QEMM, NetRoom, DOS 7 from both NOVEL and Microsoft, IBM's
  1031.      OS/2, Chicago/Cairo, Windows NT, Unix, etc.) I think that AutoCon
  1032.      may have a rather limited future.  Since I use it I will continue to
  1033.      enhance it for myself and make new releases available.  I will no
  1034.      longer attempt to keep up with all the options from all of the
  1035.      operating environments.
  1036.  
  1037.      
  1038.  
  1039.                                    LICENSE
  1040.  
  1041.  
  1042.      This version of AutoCon is being distributed as "Free" software.
  1043.      Feel free to use this version on any machines you own, and
  1044.      distribute it among your friends.  This may be the last release of
  1045.      AutoCon, or there may be future (non-free) releases of AutoCon.  I
  1046.      don't know which way AutoCon will go, so enjoy this release, and we
  1047.      will see what the future holds.
  1048.  
  1049.  
  1050.      Larry Weaver hereby disclaims all warranties relating to this
  1051.      product, whether express or implied, including without limitation
  1052.      any implied warranties of merchantability or fitness for a
  1053.      particular purpose.  Larry Weaver cannot and will not be liable
  1054.      for any special, incidental, consequential, indirect, or similar
  1055.      damages due to loss of data or any other reason, even if Larry
  1056.      Weaver or an authorized Larry Weaver agent has been advised of
  1057.      the possibility of such damages.  In no event shall the liability
  1058.      for any damages ever exceed the price paid for the license to use
  1059.      this software, regardless of the form and/or extent of the claim.
  1060.      The user of this program bears all risk as to the quality and
  1061.      performance of the software.  Use of this program acknowledges
  1062.      this disclaimer of warranty.
  1063.